home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 11 / Mac Magazin and MacEasy Magazine CD - Issue 11.iso / Sharewarebibliothek / Schoner / The Swarm 1.1.1 Folder / The Swarm README < prev   
Text File  |  1995-05-21  |  11KB  |  250 lines
  1. _______________________________________________________________
  2. THE SWARM 1.1.1  —  A freeware Screensaver Module
  3.  
  4. By Leo Breebaart, Copyright ©1994-95 Kronto Software
  5.  
  6. Internet e-mail: leo@cp.tn.tudelft.nl        
  7. Internet WWW page: http://www.cp.tn.tudelft.nl/leo/kronto.html
  8. _______________________________________________________________
  9.  
  10.  
  11. Description
  12.  
  13.   The Swarm is a simple, but surprisingly elegant and mesmerizing
  14.   line animation, in which a number of small line segments (the ‘bees’)
  15.   chase one other segment (the ‘queen bee’) across the screen.
  16.   
  17.  
  18. Features
  19.  
  20.     •    Compatible with After Dark (both 2.0 and 3.0), DarkSide of the Mac and UnderWare.
  21.     •  Flicker-free animation with smooth fade-out/fade-in effects.
  22.   •  Intelligent Demo Mode (as if anybody cares :—) ).
  23.     •  Does not use any permanent System memory under After Dark 2.0.
  24.     •  Has an animated About Box and thumbnail.
  25.     •  Runs under both MultiModule and the Randomizer — without crashing.
  26.     •  Comes with extensively documented source code (THINK C 7.0.4 format).
  27.     •  Both the module and the source code are free.
  28.   
  29.  
  30. Restrictions & Technical Remarks
  31.  
  32.   •    The Swarm needs Color QuickDraw to run. A color screen is not essential,
  33.     however: on a Black & White SE/30 the module works just fine.
  34.  
  35.   •  Multiple-monitor setups are supported, but not actively used — the animation
  36.     always runs on the main monitor only (and will simply black out any other screens).
  37.  
  38.     •  I cannot guarantee that The Swarm will work with versions of After Dark
  39.     earlier than 2.0u. The same holds for any other programs that are supposed
  40.     to be able to play After Dark modules (except for DarkSide and UnderWare,
  41.     which I had access to). In all such cases, The Swarm may run, or it may not.
  42.     Feedback about compatibility issues will be much appreciated.
  43.     
  44.     •  At the moment of writing the latest version numbers of the screensavers
  45.     The Swarm has been tested to work with are 3.0b for After Dark, 4.2 for DarkSide
  46.     and 1.0.1 for UnderWare. Free updaters for these programs are readily available
  47.     on the Internet and on all the major commercial software archives. See also the
  48.     URL appendix at the end of this document.
  49.         
  50.  
  51. Who thought of it first
  52.  
  53.   I first came across this animation in an X Windows program called xswarm,
  54.   written by Jeff Butterworth in the early 90s. I liked it so much that I
  55.   decided to write an After Dark version. Most of the module I had to create
  56.   from scratch, but the core algorithm was taken straight from Jeff’s
  57.   sources. My module, of course, lacks all the many options that his X Windows
  58.   program has. If you have access to an appropriate machine, be sure to
  59.   check out xswarm — it’s great.
  60.     
  61.   
  62. Who else thought of it first
  63.  
  64.   Shortly after I began programming this module it was brought to my
  65.   attention that there already was a ‘swarm’ After Dark module, called
  66.   ColorSwarm!, written by Dan Walkowski in 1991.
  67.  
  68.   Since his module looked a bit different from what I had in mind, I just went
  69.   ahead and wrote my own version anyway. But be sure to check out his module. 
  70.   He has more parameters for you to set, his ColorSwarm! works on B&W
  71.     machines without Color QuickDraw, and I believe he also makes use of multiple 
  72.     monitors, which I don’t.
  73.   
  74.   
  75. Version history
  76.  
  77.     1.0        25 Mar 1994
  78.                         —    Initial release.
  79.  
  80.     1.1        24 Feb 1995
  81.                         —    Bees on 256-color screens will now change color as they move along. Added
  82.                                 a new slider to control the color-changing speed. 
  83.                         —    Had to sacrifice the 'smooth fade' checkbox to make room for the new slider.
  84.                                 The Swarm now always fades smoothly, if possible.
  85.                         —    The About Box now wil take advantage of After Dark 3.0’s expanded
  86.                                 about box area (provided you’re running 3.0, of course. Duh.).
  87.                         —    Added animated thumbnail for After Dark 3.0.
  88.                         —    Cleaned up the source code.
  89.  
  90. 1.1.1    19 May 1995
  91.                         —    Fixed a bug that caused crashes for people running the module on a Mac IIsi
  92.                                 under DarkSide.
  93.                         —    Shortened the duration of the fade-out when the module kicks in, and entirely
  94.                                 removed the fade-in when the module ends. Having to wait so long for the 
  95.                                 fade effects to take place got on people’s nerves (including mine).
  96.                         —    Removed all references to the After Dark FTP Site and the Programmers’ List,
  97.                                 because both are now (temporarily) defunct.
  98.     
  99.  
  100. Credits & Acknowledgments
  101.  
  102.   First of all, my thanks to Jeff Butterworth for giving me permission to ransack 
  103.     his code and port his algorithm to the Mac.
  104.  
  105.   For technical assistance, emotional support and beta-testing I owe a sincere 
  106.   thank-you to Rodney “Jewelbox” Jacks, to Lloyd “Screensaver FAQ” Wood, and to 
  107.   all the members of the After Dark programmers mailing list. 
  108.  
  109.     Without Timo Eloranta’s error reports and his willingness to crash his Mac for me I would
  110.     never have been able to track down the IIsi-killing bug in version 1.1.
  111.  
  112.   Special thanks to Jonas Englund, for allowing me to use, adapt and distribute
  113.   his CLUT fading code.
  114.   
  115.   Extra special thanks to David “Bat Signal” Zwiefelhofer, to Joseph 
  116.   “Peek-a-Boo” Judge, and to Berkeley Systems themselves for releasing sample 
  117.   source code and documentation without which this module would never have 
  118.   been written in the first place.
  119.   
  120.     The Swarm was created using THINK C 7.0.4,  Think Reference 2.0.1,
  121.     ResEdit 2.1.3, BBEdit 3.1.1, and Adobe Photoshop 3.0.1.
  122.  
  123.  
  124. Known Problems
  125.  
  126.     •    The color-changing bees was the single most-requested feature for
  127.     The Swarm, so I added it. However, the current implementation is just
  128.     a quick interim hack to make it work for at least some of the people. In
  129.     particular: the bees will only change color on displays in 8-bit (256 color)
  130.     mode, never in modes with a higher or lower number of colors. Fixing this
  131.     will be one of the top priorities for the next version of The Swarm.
  132.  
  133.     •    The color-changing slider has no effect in demo-mode.
  134.  
  135.     •    Under certain very rare circumstances (specifically: if you have a
  136.     multi-monitor setup in which your main monitor (the one with the menu
  137.     bar) is not placed in the ‘left-upper-most’ position in the Monitors control
  138.     panel) the module will start drawing garbage on your screen when
  139.     activated. This is an entirely cosmetic bug, and I know precisely what’s
  140.     causing it — I just don’t know how to fix it, yet.
  141.  
  142.     •    Under certain other not-so-rare circumstances (specifically: if After
  143.     Dark starts displaying a “Please Wake Up” message while the module
  144.     is running, e.g. when a background application wants your attention) the
  145.     module will also start drawing garbage to your screen. This too, is an entirely
  146.     cosmetic bug — but I’l be darned if I know what’s causing it, or how to
  147.     fix it.
  148.  
  149.     •    Those of you interested in the source code should be aware (you may
  150.     have already gathered it from the above few paragraphs :-) ) that I am
  151.     not an experienced Macintosh programmer — in fact, The Swarm was my
  152.     very first programming effort for the Mac. This means that the code
  153.     may have hidden problems that I’m simply not aware of. Don’t assume
  154.     that I’m always doing things the ‘right’ way!
  155.        
  156.     I would appreciate hearing about any other bugs or problems you may encounter 
  157.     with The Swarm.
  158.         
  159.         
  160. A Word about Memory and CPU-time
  161.  
  162.   The Swarm tries to be a well-behaved, system-friendly module. It will, for
  163.   instance, not reserve any permanent memory in your system heap. That
  164.   means that having The Swarm selected costs you no more memory than having
  165.   the default ‘Starry Night’ module selected, as long as After Dark has not
  166.   taken over the screen.
  167.   
  168.   Of course, once After Dark kicks in, The Swarm does need loads of memory
  169.   for its animation (the larger your screen the worse it gets), which it
  170.   will try to allocate out of the free memory you have at that moment. In
  171.   low-memory situations (e.g. if you have lots of applications open), this
  172.   attempt may be unsuccessful, and the module will refuse to run with an
  173.   appropriate error message. The reason I am explaining all of this in such
  174.   detail is that the upshot of this strategy is that you may see The Swarm
  175.   ‘fail’ to run more often than other modules. But that is entirely
  176.   intentional, and only means that it is your real applications which are
  177.   getting access to every last Kb of your available memory. Isn’t that how 
  178.   things should be?
  179.   
  180.   On fast Macs (Quadra’s or higher), finally, you will want to use the ‘Swarm
  181.   Speed’ slider in the control panel to slow the animation down. Here too, I 
  182.   just want to point out that if you do this, then the extra CPU time will be
  183.   given back to the system. The Swarm will never use more processing power
  184.   then it really needs.
  185.  
  186.         
  187. Still To Do
  188.  
  189.   Version 1.1.1 is just a minor upgrade to version 1.0. There will be a major new 
  190.     version of The Swarm, although for the coming months (I’m writing this in 
  191.     May 1995) I won’t have time to work on it, sorry. For The Swarm 2.0
  192.     I intend the following features and fixes:
  193.   
  194.     •    PowerMac native code.
  195.     •    Allow color-changing bees on non-CLUT devices (i.e. non-8-bit modes)
  196.   •    Add more parameters for you to play with.
  197.     •    Make Queen Bee behave more intelligently and interestingly.
  198.   •    Multiple Swarms, or maybe multiple Queen Bees (there’s a difference!).
  199.   •    Add sound/music.
  200.   •    Add an option to make the entire Swarm move 3-dimensionally, with
  201.             depth indicated by perspective projection and color brightness.
  202.   •  Support old, non-Color Quickdraw B&W Macs.
  203.  
  204.   If you have any suggestions to add to this list, let me know.
  205.   
  206.   
  207. For Programmers
  208.  
  209.     The most recent version of the After Dark programmer’s interface (which
  210.     also gets updated sometimes — the copy that came with your diskette may
  211.     be outdated!) is available from the major Internet archive sites such
  212.     as sumex.stanford.edu, mac.archive.umich.edu and their mirrors. 
  213.  
  214.     You may also want to take a look at ScreenFlip, another screensaver 
  215.     module I wrote, which also comes with documented source code.
  216.  
  217.  
  218.  Final Remark    
  219.  
  220.     Nobody who owns a Macintosh screensaver package should be without
  221.     the most recent version of Lloyd Wood’s Screensaver FAQ (Frequently 
  222.     Asked Questions) List. Copies of this list are also available from all major
  223.     archive sites on or off the Internet. It is a must-have. Trust me.  
  224.   
  225. Enjoy,
  226.  
  227. __
  228. Leo Breebaart (leo@cp.tn.tudelft.nl)
  229.  
  230. _______________________________________________________________
  231. Appendix: URLs
  232.  
  233.     Here are URLs for some of the Internet resources mentioned in this document. 
  234.   Newer versions of these files may of course have been released by the time
  235.     you read this. Most of the files are available from many other sites as well.
  236.  
  237.     Kronto Software WWW/ftp sites (for info about me and my other programs):
  238.                 http://www.cp.tn.tudelft.nl/leo/kronto.html
  239.                 ftp://kronto.cp.tn.tudelft.nl/pub/macintosh/
  240.     DarkSide of the Mac 4.2:
  241.                 ftp://ftp.apple.com/dts/mac/hacks/darkside-of-the-mac-4-2.hqx
  242.     Macintosh FAQs WWW/ftp sites:
  243.                 http://www.astro.nwu.edu/lentz/mac/faqs/home-faqs.html
  244.                 http://www.ee.surrey.ac.uk/Personal/L.Wood/screensavers/
  245.                 ftp://rtfm.mit.edu/pub/usenet/news.answers/macintosh/
  246.     Original X-Windows xswarm program:
  247.                 ftp://ftp.x.org/R5contrib/xswarm.2.3.tar.Z
  248. _______________________________________________________________
  249.  
  250.